IC96734: ANS9365E ERROR DURING RESTORE OF VIRTUAL MACHINE WITH API ERROR MESSAGE "A SPECIFIED PARAMETER WAS NOT CORRECT"

IBM Tivoli Storage Manager (TSM) Client 7.1.0 Downloads
IBM Tivoli Storage Manager (TSM) client 6.3.2.x interim fix downloads - EOL

APAR status

• Closed as program error.

Error description

• During the restore of a VMware virtual machine, the restore may
  fail with:
  
  09/03/2013 15:51:40 ANS9365E VMware vStorage API error for
  virtual machine 'SGHQVCTR01'.
     TSM function name : visdkCreateVM
     TSM file          : vmvisdk.cpp (4897)
     API return code   : 67
     API error message : A specified parameter was not correct.
  
  09/03/2013 15:51:40 ANS5250E An unexpected error was
  encountered.
     TSM function name : vmCreateNewVmMachine
     TSM function      : Can not create virtual machine
     TSM return code   : 4389
     TSM file          : ..\..\common\vm\vmcommonrestvddk.cpp
  (822)
  09/03/2013 15:51:40 ANS9404E Error creating the specified
  Virtual Machine. See log files for more information.
  
  This problem will normally occur when restoring virtual
  machine which is a vCenter. The virtual machine configuration
  property "guestinfo.vf.tc.clientLicenseState" causes the
  failure of creating virtual machine during restore.  This
  property indicates the information written by the client
  when a VM vFabric component comes online, and it places a
  message into guestinfo. This is later used by the vFabric
  server. Thus, every time vFabric component will be started,
  this value will be written to this key/value pair by the
  client.
  
  This key/value pair is not important from
  backup/restore perspective and should be omitted in Tivoli
  Storage Manager for Virtual Environment datamovers.
  This information was recently published in a Microsoft
  KB article: http://kb.vmware.com/selfservice/microsites/search.d
  o?language=en_US&cmd=displayKC&externalId=2059585
  

Local fix

• 1. Use "testflag VMBACKUP_SAVE_LOCAL" in the dsm.opt file to
  generate and save an OVF file for restoring the virtual machine.
  The OVF file will be created in the VMBACKDIR directory that is
  defined in the dsm.opt file
  
  2. Remove the key/pair of following section of of the .ovf file:
  
  <Item tsm:id="30">
  <extra:key>guestinfo.vf.tc.clientLicenseState</extra:key>
          <extra:value>
  ...
  </extra:value>
        </Item>
  
  3. Append "_test" to the name of the ovf file. For Example :
   <orig ovf name>_test.ovf
  
  4. Repeat the restore with "testflag VMRESTORE_OVF_OVERRIDE"
  specified in the dsm.opt file.
  
  The testflag will cause the restore to look for the OVF file
  with _test as part of the name.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: Backup-archive client versions 6.3 and 6.4   *
  *                 running on all Microsoft Windows and Linux   *
  *                 platforms.                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: See ERROR DESCRIPTION                   *
  ****************************************************************
  * RECOMMENDATION: Apply fixing level when available. This      *
  *                 problem is currently projected to be fixed   *
  *                 in level 6.4.2. Note that until the fixing   *
  *                 level is available, this information is      *
  *                 subject to change at the discretion of IBM.  *
  ****************************************************************
  *
  

Problem conclusion

• During restore "guestinfo.vf.tc.clientLicenseState" is skipped.
  

Temporary fix

• 6.3.2.4 on Windows and Linux x86
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Modules/Macros

• DSMAGENT
  

Fix information

• Fixed component name

  TSM CLIENT

• Fixed component ID

  5698ISMCL

Applicable component levels

• R64L PSY

     UP

• R64W PSY

     UP